# Configuration file for the Sphinx documentation builder.
#
# For the full list of built-in configuration values, see the documentation:
# https://www.sphinx-doc.org/en/master/usage/configuration.html

# -- Project information -----------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information

project = '雪云飞星的知识备忘录'
copyright = '2025, fuhaowen'
author = 'fuhaowen'
release = '1.0.0'

# -- General configuration ---------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

extensions = [
    'myst_parser',
    'sphinx_design',
]

templates_path = ['_templates']
exclude_patterns = []

language = 'zh_CN'

# -- Options for HTML output -------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output

html_theme = "pydata_sphinx_theme"
html_static_path = ['_static']

html_theme_options = {
    "navbar_align": "left",
    "footer_start": ["copyright"],   # 左侧 footer 内容（空列表表示清空）
    "footer_end": [],                # 右侧 footer 内容（空列表表示清空）
    "header_links_before_dropdown": 2,

    "show_nav_level": 2,             # 控制目录展开的层级
    "navigation_depth": 4,           # 允许目录展示到第4级标题
    "collapse_navigation": False,    # 不折叠目录（默认是True会合起来）
}

html_title = "【知识备忘录】@雪云飞星"

html_show_sourcelink = False

html_css_files = [
    'css/custom.css',  # 这是您自己的自定义样式文件
    # 加入下面这行来加载 Font Awesome 6 的图标
    "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.2/css/all.min.css",
]